create-audit-module(1)    asadmin Utility Subcommands   create-audit-module(1)

NAME
       create-audit-module - adds an audit module

SYNOPSIS
           create-audit-module [--help]
           --classname classname
           [--property(name=value)[:name=value]*]
           [--target target]
           audit_module_name

DESCRIPTION
       The create-audit-module subcommand adds the named audit module for the
       Java class that implements the audit capabilities. Audit modules
       collect and store information on incoming requests (from, for example,
       servlets and EJB components) and outgoing responses.

       This subcommand is supported in remote mode only.

OPTIONS
       --classname
           The name of the Java class that implements this audit module. If
           not specified, this option defaults to
           com.sun.enterprise.security.Audit.

       --help, -?
           Displays the help text for the subcommand.

       --property
           Optional keyword-value pairs that specify additional properties for
           the audit module.

           Audit module properties that are defined by GlassFish Server are as
           follows:

           auditOn
               If true, specifies that the audit module is loaded and called
               by the GlassFish Server audit library at audit points.

           Other available properties are determined by the implementation of
           the audit module.

       --target
           Specifies the target on which you are creating the audit module.
           Valid values are as follows:

           server
               Creates the audit module for the default server instance server
               and is the default value.

           configuration_name
               Creates the audit module for the named configuration.

           cluster_name
               Creates the audit module for every server instance in the
               cluster.

           instance_name
               Creates the audit module for a particular server instance.

OPERANDS
       audit_module_name
           The name of this audit module.

EXAMPLES
       Example 1, Creating an audit module

               asadmin> create-audit-module
               --classname com.sun.appserv.auditmodule
               --property defaultuser=admin:Password=admin sampleAuditModule
               Command create-audit-module executed successfully

EXIT STATUS
       0
           command executed successfully

       1
           error in executing the command

SEE ALSO
       delete-audit-module(1), list-audit-modules(1)

       asadmin(1M)

Java EE 8                         22 Dec 2010           create-audit-module(1)
